<text><span class="style8">temOfList(list,[lineDelimChar],keyItemNum[,itemDelimChar])</span><span class="style7">• returns a list whose lines contain only one item from each line of the original list</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixed bug to handle empty list- itemDelimChar is now optional parameter</text>
</content>
<name>itemOfList</name>
<script></script>
</card>
card_7500.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">istNOTlist(list1,list2[,lineDelimChar,C|S|D])</span><span class="style7">• returns the list which is the complement of the intersect of two lists• the fourth parameter may include "C" for case-sensitive compares, "S" to indicate the lists are sorted, or "D" to indicate the lists are sorted in descending order• the operation works faster on sorted lists• even if lines appear more than once in either list, they will only appear once in the returned list</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixed bug to handle empty lists</text>
</content>
<name>listNOTlist</name>
<script></script>
</card>
card_7225.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">istORlist(list1,list2[,lineDelimChar,C|S|D])</span><span class="style7">• returns the list which is the union of two lists• the fourth parameter may include "C" for case-sensitive compares, "S" to indicate the lists are sorted, or "D" to indicate the lists are sorted in descending order• the operation works faster on sorted lists• even if lines appear more than once in either list, they will only appear once in the returned list</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixed bug to handle empty lists</text>
</content>
<name>listORlist</name>
<script></script>
</card>
card_7035.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">istANDlist(list1,list2[,lineDelimChar,C|S|D])</span><span class="style7">• returns the list which is the intersect of two lists• the fourth parameter may include "C" for case-sensitive compares, "S" to indicate the lists are sorted, or "D" to indicate the lists are sorted in descending order• the operation works faster on sorted lists• even if lines appear more than once in either list, they will only appear once in the returned list</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixed bug to handle empty lists</text>
</content>
<name>listANDlist</name>
<script></script>
</card>
card_6761.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">eastListLine(list[,lineDelimChar,C|N,keyItemNum, itemDelimChar])</span><span class="style7">• returns the number of the line with the least value• third parameter may include "N" to indicate numeric data or "C" for case-sensitive comparisons• if a keyItemNum is specified, only that item of each line will be examined</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixed bug to handle empty lists</text>
</content>
<name>leastListLine</name>
<script></script>
</card>
card_6637.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">reatestListLine(list[,lineDelimChar,N|C,keyItemNum, itemDelimChar])</span><span class="style7">• returns the number of the line with the greatest value• third parameter may be "N" to indicate numeric data or "C" for case-sensitive comparisons• if a keyItemNum is specified, only that item of each line will be examined</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixes bug to handle empty list</text>
</content>
<name>greatestListLine</name>
<script></script>
</card>
card_6398.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">eplaceListLine(list,[lineDelimChar],newLine,lineNum)</span><span class="style7">• returns the same list but with the contents of newLine replacing the contents of line lineNum• much like saying "put newLine into line lineNum of myList" in HyperTalk• if lineNum > 0, but the line doesn't already exist, the list will be extended to accommodate it, creating blank lines if necessary.</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixed bug to handle empty list or newLine</text>
</content>
<name>replaceListLine</name>
<script></script>
</card>
card_8115.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">emoveListLine(list,[lineDelimChar],lineNum)</span><span class="style7">• returns the same list but with line lineNum removed• much like saying "delete line n of myList" in HyperTalk• lineNum specifies which line of the list to remove</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixed bug to handle empty list</text>
</content>
<name>removeListLine</name>
<script></script>
</card>
card_5650.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">nsertListLine(list,[lineDelimChar],newLine,beforeLineNum)</span><span class="style7">• returns the same list but with the contents of newLine (& a line delimiter) inserted before a given line• much like saying "put newLine & return before line lineNum of myList" in HyperTalk• if beforeLineNum > 0, but the line doesn't already exist, the list will be extended to accommodate it, creating blank lines if necessary.</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixed bug so new line could be added immediately after existing list- fixed bug to handle empty list or newline</text>
</content>
<name>insertListLine</name>
<script></script>
</card>
card_5465.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">hichListLine(list,[lineDelimChar],theLine[,C|S|D|N, keyItemNum,itemDelimChar])</span><span class="style9"></span><span class="style7">• returns the line number on which the contents of theLine were found• the fourth parameter may include "C" for case-sensitive compares, "S" to indicate that the list is sorted, or "D" to indicate that the list is sorted in descending order, or "N" to indicate that the data of interest are numeric• if theLine appears more than once in the list, the location of the first occurrence (from the top) will be returned• if the list is not sorted, and theLine is not found in the list, the function returns 0• if the list is sorted, and theLine is not found, the function returns a negative value which indicates which line theLine should be inserted before to be in order• keyItemNum can be used to restrict the comparison of theLine to only one item within each line of the list. In this case theLine should not contain a whole line, but just the item of interest.• if you indicate that the list is sorted, and use a key field, or indicate case-sensitive or numeric data, make sure the list is sorted by those same criteria, otherwise the results will not necessarily make sense</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- bug fix to handle empty list or line number</text>
</content>
<name>whichListLine</name>
<script></script>
</card>
card_5288.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">ortList(list[,lineDelimChar,C|N|D,keyItemNum,itemDelimChar)</span><span class="style7">• returns a sorted list• the third parameter may include "C" for case-sensitive sorting, "N" for numeric sorting (so that 100 > 20), or "D" to sort in descending order• keyItemNum may be used to indicate which item of each line should be used for the sort</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixed major bug which caused sorted order to be incorrect in some cases (sorry!)- fixed bug to handle empty list</text>
</content>
<name>sortList</name>
<script></script>
</card>
card_4921.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">thListLine(list,[lineDelimChar],lineNum)</span><span class="style9"></span><span class="style7">• returns the nth line of a list• much like saying "line n of myList" in HyperTalk• lineNum specifies which line of the list to return• the contents of the nth line are returned without the trailing delimiter character</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.1- fixes bug to handle empty list</text>
</content>
<name>nthListLine</name>
<script></script>
</card>
card_4828.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style8">umListItems(list[,lineDelimChar])</span><span class="style9"></span><span class="style7">• returns the number of lines in a list• much like saying "the number of lines in myList" in HyperTalk</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>current version: 1.0</text>
</content>
<name>numListLines</name>
<script></script>
</card>
card_4597.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>• these are all XFCN's, so they all return a value to HyperCard• the first parameter is always the list container• the second parameter is usually the list delimiter character• optional parameters are indicated in square brackets• note that some optional parameters may be left empty so that default values will be used, but not missing altogether• the default line delimiter character (lineDelimChar) is "return"• the default item delimiter character is "comma"• although it is not a required feature of lists passed to these XFCN's, some of the functions internally require a final line delimiter character as the last character of the list. They will ensure that this final character is there before proceeding, and as a matter of consistency, all lists returned by these functions will have a final line delimiter character attached.• where it is an option, case-sensitive comparisons for sorting & matching are always faster• passing "!" as the first parameter to these XFCN's will return my copyright notice, and "?" will return the syntax. Passing incorrect numbers of parameters may also cause the XFCN to return the syntax</text>
</content>
<name>General Details</name>
<script></script>
</card>
card_4098.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>Internet mail: dward@oise1.oise.on.caEarth mail: Doug Ward 20 Page St. Toronto, Ontario M6G 1J2Even if you don't want to send me money (although I do expect you to respect the shareware terms I described in "Legal Stuff"), I'd like to get feedback about these XFCN's. Please report any bugs, confusion, suggestions, or desires to me.If you want to purchase my source code for learning (non-commercial) purposes, make me an offer.</text>
</content>
<name>How to Contact me</name>
<script></script>
</card>
card_4051.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style7"> I wrote these XFCN's to provide a simple and versatile programming interface for manipulating text lists in HyperCard. For the purposes of these XFCN's, </span><span class="style2">lists</span><span class="style7"> are composed of </span><span class="style2">lines</span><span class="style7"> which may be composed of multiple </span><span class="style2">items</span><span class="style7">. By default, lines and items correspond to HyperTalk's line and item chunks — i.e. lines are delimited by return characters and items are delimited by commas — but you may use any single character to delimit lines or items (of course, not the same character for both). This gives you more flexibility as a programmer, allowing you to do things like embed lists within lists.This is version 1.1 which fixes some minor and major bugs.</span></text>
</content>
<content>
<layer>background</layer>
<id>9</id>
<text>Version 1.1 of this stack includes version 1.1 of almost all of the XFCN's.This version fixes a few minor annoying bugs, and one major one in the sortList XFCN.To view the version histories for the various individual XFCN's, click the version button on the card of interest, or choose "Version History" from the XFCN's menu.</text>
(1994)[Mac].iso/XCMDS&XFCNS/List XFCN's 1.1/List XFCN's 1.1/BMAP_3810.png){kind=link}
(1994)[Mac].iso/XCMDS&XFCNS/List XFCN's 1.1/List XFCN's 1.1/PATs.png){kind=link}